home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS14.ADF / Progs / PETrans / Petrans.doc < prev    next >
Text File  |  1989-01-28  |  3KB  |  76 lines
  1.  
  2.                 *** Petrans (PETASCII Translator) for the Amiga ***
  3.                            *** by James David Walley ***
  4.  
  5.       This is a VERY simple utility that allows you to convert text files
  6. written in PETASCII (often found on Commodore BBSs) to regular ASCII, so
  7. that they can be typed and edited on the Amiga.
  8.  
  9.       PETRANS works using input/output redirection.  In case you haven't
  10. read the AmigaDOS manual, all this means is that you specify the input and
  11. output file names on the same line as the command, in this form:
  12.  
  13.                      petrans < (inputname) > (outputname)
  14.  
  15.       For example, say you downloaded a file of BBS numbers written in
  16. PETASCII, and named (rather originally) "BBS_numbers".  Suppose that you
  17. wanted the file converted to ASCII.  You would first decide on a name for
  18. your ASCII file (it can't be the same as the PETASCII one).  In a burst of
  19. originality of your own, you decide to name the new file "BBS".  You would
  20. then enter the following command at the CLI prompt:
  21.  
  22.                      petrans < BBS_numbers > BBS
  23.  
  24. and the program will take care of the rest.
  25.  
  26.  
  27. Technical Notes
  28. --------- -----
  29.  
  30.       The difference between PETASCII and ASCII is that the upper- and
  31. lower-case character sets are switched.  In addition, PETASCII has a second
  32. location of the uppercase set, exactly 96 numbers above the first list.
  33. This second location will produce garbage (other character sets, etc.) on
  34. the Amiga, while the first will give you lowercase instead of uppercase,
  35. and any PETASCII lowercase will print on the Amiga as uppercase.
  36.  
  37.       The first thing the program does is convert all CR (carriage returns)
  38. in the file to LF (linefeeds).  This is to make it possible to use the type
  39. command and have the text scroll up the screen, instead of continuously
  40. writing to the same screen line.
  41.  
  42.       Following this, PETRANS automatically converts the second uppercase
  43. character set to the first one, getting rid of the "unplanned"
  44. non-alphanumeric characters.  Then the upper- and lower-case sets are
  45. reversed, and the file is written to disk in its converted form.  All this
  46. will be visible in the C source code for the program.
  47.  
  48.  
  49. Acknowledgements
  50. ----------------
  51.  
  52.       I want to thank the management and staff at Com-Soft Computers in
  53. Everett, Washington, for letting me work with their C compiler.
  54.  
  55.       As I said before, this is a very simple program, and I'm sure that
  56. many things could be done to give it some bells and whistles.  You are of
  57. course welcome to modify the program as much as you want, as long as you
  58. include the C source along with the program, and do not remove my credit
  59. from the source code.  Since this is my first C program, I think I should be
  60. allowed my ego trip.  (On that subject, if you feel that this program saved
  61. your life, made you rich in the stock market, improved your sex life, etc.,
  62. you are welcome to make an appropriate donation (ten cents?) to James David
  63. Walley, 120 West Casino Road-Apt. 30E, Everett, Washington, 98204.  This is
  64. solely so that I can go around telling everyone that I'm a professional
  65. programmer.)
  66.  
  67.       And, if you have a modem, call the Public Domain Silo at:
  68.  
  69.                            (206) 775-2650
  70.                            (206) 347-0243
  71.  
  72.                                  --James David Walley
  73.  
  74.  
  75.  
  76.